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Introduction 


The Microsoft Windows Quick Reference is a companion to the other manu- 
als in the Microsoft Windows Software Development Kit. It is designed to 
provide brief, summarized information about Windows functions and mes- 
sages and to provide page references to the Microsoft Windows Program- 
mer’s Reference, where more thorough descriptions of each function and 
message can be found. 


Each function is listed alphabetically and is followed by a page reference 
to the Microsoft Windows Programmer’s Reference. 


Function parameters and return values have a lowercase prefix that indi- 
cates the general type of the parameter, followed by one or more words 
that describe the content of the parameter. The standard prefixes used in 
parameter and variable names are defined as follows: 


Prefix Meaning 


c Character (a one-byte value) 

b Boolean (a nonzero value means true, zero means false) 
f Bit flags packed into a 16-bit integer 

n Short (16-bit) integer 

l Long (32-bit) integer 

w Short (16-bit) unsigned integer 

dw Long (32-bit) unsigned integer 

h 16-bit handle 

p Short (16-bit) pointer 

lp Long (32-bit) pointer 

pt X, Y coordinates packed into an unsigned 32-bit integer 
rgb An RGB color value packed into 32-bit integer 


If no lowercase prefix is given, the parameter is a short integer whose name 
is descriptive. 
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A Windows Message Index lists each message alphabetically and gives a 

page reference to the Microsoft Windows Programmer’s Reference. Follow- 
ing the Index, four alphabetic listings (Window Messages, Button-Control 
Messages, E:dit-Control Messages, and List-Box Messages] describe the 16- 
bit and 32-bit parameters passed with each message. If a parameter is not 


used by the message, a hyphen (-) is given. A numeric list of Windows 
messages follows the alphabetic listing. 


Windows Functions 


AccessResource page 215 
AccessResource(hInstance,hResInfo):nFile 


Sets file pointer for read access to resource hResInfo. Returns DOS file 
handle. 


AddAtom page 220 
AddAtom(/pString):wAtom 


Creates an atom for character string /pString. 
AddFontResource page 207 

AddFontResource(IpFilename):nFonts 

Adds font resource in /pFilename to system font table. 
AdjustWindowRect see Update 

Adjust WindowRect(/lpRect,/Style, bMenu) 


Converts client rectangle to a window rectangle. 


AllocResource page 214 
AllocResource(h/nstance,hResInfo,dwSize):hMem 


Allocates dwSize bytes of memory for resource hResInfo. 
AnsiLower page 218 

AnsiLower(IpStr):cChar 

Converts character string lpStr to lowercase. 
AnsiNext page 219 

AnsiNext(/pCurrentChar):lpNext Char 


Returns long pointer to next character in string [pCurrentChar. 
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AnsiPrev page 219 
AnsiPrev(/pStart,lpCurrentChar):lpPrevChar 


Returns long pointer to previous character in string /pStart. 
loCurrentChar points to current character. 


AnsiToOem page 217 


AnsiToOem(/pAnsiStr,lpOemStr):b Translated 
Converts ANSI string to OEM character string. 


AnsiUpper page 218 
AnsiUpper(lpStr):cChar 


Converts character string (or character if [pString high word is zero) to 
uppercase. 


AnyPopup page 37 

AnyPopup():6 Visible 

Indicates whether or not a popup style window is visible on the screen. 
Arc page 114 

Are(hDC,X1, Y1,X2, Y2,X3, Y3,X4, ¥4):bDrawn 


Draws arc from X38, Y3 to X4, Y4, using current pen and moving coun- 


terclockwise. Arc’s center is at center of rectangle given by X1, Y1 and 
AL, V2. 


BeginPaint page 73 
BeginPaint(hWnd,lpPaint):hDC 


Prepares window for painting, filling structure at /pPaint with painting 
data. 


BitBlt page 116 
BitBlt(hDestDC,X, Y,n Width, nHeight,hSrcDC,XSre, YSrc,dwRop):bDrawn 


Moves bitmap from source device to destination device. Source origin 
is at XSrc, YSre. X, Y, nWidth, nHeight give bitmap origin and dimen- 
sions on destination device. dwRop defines how source and destination 
bits are combined. 
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Bring Window ToTop page 36 
Bring Window ToTop(h Wnd) 


Brings popup or child window to top of stack of overlapping windows. 


BuildCommDCB page 228 
BuildCommDCB(IpDef,lpDCB):nResult 
Fills device control block [pDCB with control codes named by [pDef. 


CallMsgFilter see Update 
CallMsgFilter(lpMsg,nCode):bResult 


Passes message and code to current message-filter function. Message- 
filter function is set using Set WindowsHook. 


CallWindowProc page 25 
CallWindowProc(lpPrevWndFunc,h Wnd,wMsg,wParam,!Param):lReply 


Passes message information to the function specified by 


loPrevWndF unc. 


Catch page 195 
Catch(lpCatchBuf):n ThrowBack 


Copies current execution environment to buffer [pCatchBuf. 


ChangeClipboardChain page 55 
ChangeClipboardChain(hWnd,hWndNezt):bRemoved 


Removes hWnd from clipboard viewer chain, making hWndNezt 
descendant of hWna’s ancestor in the chain. 


ChangeMenu page 62 


ChangeMenu(hMenu, wlDChangeltem,lpNewltem,wiDNewltem, 
wChange):bChanged 


Appends, inserts, deletes, or modifies a menu item in hMenu. 


CheckDlgButton page 45 
CheckDlgButton(hDlg,nIDButton, wCheck) 


Places or removes check next to button, or changes state of 3-state 
button. 
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CheckMenultem page 65 
CheckMenultem(AMenu, wIDCheckItem, wCheck):bOldCheck 
Places or removes checkmarks next to popup menu items in hMenu. 
CheckRadioButton page 46 


CheckRadioButton(hDlg,n/DFirstButton,nIDLastButton,nID CheckButton) 


Checks nIDCheckButton and unchecks all other radio buttons in the 
group from n/DFirstButton to nIDLastButton. 


ChildWindowFromPoint page 96 

Child WindowFromPoint(hWndParent, Point):h WndChild 

Determines which, if any, child window of hWndParent contains Point. 
ClearCommBreak page 233 

ClearCommBreak(nCid):nResult 


Clears communication break state from communication device nCid. 


Client ToScreen page 95 
ClientToScreen(hWnd,/pPoint) 


Converts client coordinates into equivalent screen coordinates in place. 


ClipCursor page 91 

ClipCursor(/pRect) 

Restricts the mouse cursor to a given rectangle on the screen. 
CloseClipboard page 47 


CloseClipboard( ):bClosed 
Closes the clipboard. 


CloseComm page 226 
CloseComm(nCid):nResult 


Closes communication device nCid after transmitting current output 
buffer. 
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CloseMetaFile page 169 
CloseMetaFile(hDC):hMF 


Closes the metafile and creates a metafile handle. 


CloseSound page 235 
CloseSound( ) 


Closes play device after flushing voice queues and freeing buffers. 


CloseWindow page 35 
CloseWindow(hWnd):nClosed 


Closes the specified window. 


CombineRgn page 162 
CombineRgn(hDestRgn,hSrcRgn1,hSrcRgn2,nCombineMode):nRgn Type 


Combines, using nCombineMode, two existing regions into a new 
region. 


Copy MetaF ile page 170 
CopyMetaFile(hSrcMetaFile,lpFilename):hMF 


Copies source metafile to /pFilename and returns the new metafile. 


Copy Rect page 97 
CopyRect(IpDestRect,lpSourceRect) 


Makes a copy of an existing rectangle. 


CountClipboardFormats page 53 
CountClipboardFormats( ):nCount 


Retrieves a count of the number of formats the clipboard can render. 


CountVoiceNotes page 241 
Count VoiceNotes(n Voice):n Notes 


Returns number of notes in voice queue n Voice. 
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CreateBitmap page 131 
CreateBitmap(n Width,nHeight,cPlanes, cBitCount,|pBits):hBitmap 
Creates a bitmap having the specified width, height, and bit pattern. 


CreateBitmapIndirect page 132 
CreateBitmapIndirect(/pBitmap):hBitmap 
Creates a bitmap with the width, height, and bit pattern given by 
lp Bitmap. 

CreateBrushIndirect page 131 
CreateBrushIndirect(!pLogBrush):hBrush 


Creates a logical brush with the style, color, and pattern given by 
lpLogBrush. 


CreateCaret page 93 
CreateCaret(h Wnd,hBitmap,n Width, nHeight) 


Creates caret for hWnd using hBitmap. If hBitmap is NULL, creates 
solid flashing black block nWidth by nHeight pixels; if hBitmap is 1, 
caret Is gray. 


CreateCompatibleBitmap page 132 
CreateCompatibleBitmap(hDC,n Width, nHeight):hBitmap 
Creates a bitmap that is compatible with the device specified by hDC. 


CreateCompatibleDC page 108 
CreateCompatibleDO(hDC):hMemDC 


Creates a memory display context compatible with the device specified 


by ADC. 


CreateDC page 107 
CreateDO(/pDriverName,|pDeviceName,|pOutput,lpInitData):hDC 


Creates a display context for the specified device. 


CreateDialog page 39 
CreateDialog(Al/nstance,lp TemplateName,hWndParent,lpDialogFunc):hDlqg 


Creates a modeless dialog box. 


Windows Functions 


CreateDiscardableBitmap see Update 
CreateDiscardableBitmap(hDC,X, Y):hBitmap 


Creates a discardable bitmap. 


CreateEllipticRgn page 164 
CreateEllipticRgn(X1, Y1,X2, Y2):hRgn 


Creates an elliptical region whose bounding rectangle is defined by X1/, 
Y1, X2, and Y2. 


CreateEllipticRgnIndirect page 164 
CreateEllipticRgnIndirect(lpRect):hRgn 


Creates an elliptical region whose bounding rectangle is given by 
lpRect. 


CreateF ont page 134 


CreateF ont(nHeight,n Width,nEscapement,nOrientation,n Weight, cltalic, 
cUnderline, cStrikeOut,nCharSet,cOutputPrecision, 
cClipPreciston,cQuality,cPitchAndFamily,lpFacename):hF ont 


Creates a logical font having the specified characteristics. 
CreateFontIndirect page 137 

CreateF ontIndirect(lpLogFont):hF ont 

Creates a logical font with characteristics given by IpLogF ont. 
CreateHatchBrush page 130 

CreateHatchBrush(n/ndez,rgbColor):hBrush 

Creates a logical brush having the specified hatched pattern and color. 
CreateIC page 108 | 

CreateIC(/pDriver Name,|pDeviceName,|pOutput,lpInitData):hIC 

Creates an information context for the specified device. 
CreateMenu page 62 

CreateMenu( ):hMenu 


Creates an empty menu. 
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CreateMetaF ile page 169 
CreateMetaFile(/pFilename):hDC 


Creates a metafile display context. 


CreatePatternBrush page 130 
CreatePatternBrush(hBitmap):hBrush 
Creates a logical brush having the pattern specified by hBitmap. 


CreatePen page 128 
CreatePen(nPenStyle,n Width,rgbColor):hPen 


Creates a logical pen having the specified style, width, and color. 


CreatePenIndirect page 129 
CreatePenIndirect(/pLogPen):hPen 


Creates a logical pen with the style, width, and color given by 
lpLogPen. 


CreatePolygonRgn page 164 
CreatePolygonRgn(IpPoints,nCount,nPolyFillMod e):hRgn 


Creates a polygonal region having nCount vertices as given by 
lpPouints. 


CreateRectRgn page 163 
CreateRectRgn(X1, Y1,X2, Y2):hRgn 
Creates a rectangular region. 

CreateRectRgnIndirect page 164 
CreateRectRgnIndirect(lpRect):hRgn 


Creates a rectangular region with the dimensions given by /pRect. 


CreateSolidBrush page 129 
CreateSolidBrush(rgbColor):hBrush 


Creates a logical brush having the specified solid color. 
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CreateWindow page 26 


Create Window(/pClassName,lp WindowName, dwStyle,X, Y,n Width, nHeight, 
hWndParent,hMenu,hInstance,lpParam):hWnd 


Creates tiled, popup, and child windows. 
DefWindowProc page 21 
DefWindowProc(h Wnd,wMsg,wParam,lParam):lReply 


Provides default processing for messages an application chooses not to 
process. 


DeleteAtom page 220 
DeleteAtom(nAtom):nOldAtom 


Deletes an atom nAtom if its reference count Is zero. 


DeleteDC page 109 
DeleteDC(hDC):bDeleted 
Deletes the specified display context. 


DeleteMetaF ile page 170 
DeleteMetaFile(hMF):bF reed 


Deletes access to a metafile by freeing the associated system resources. 


DeleteObject page 138 
DeleteObject(hObject):bDeleted 


Deletes the logical pen, brush, font, bitmap, or region by freeing all 
associated system storage. 


Destroy Caret page 93 
DestroyCaret( ) 


Destroys the current caret and frees any memory it occupied. 


Destroy Menu page 62 
DestroyMenu(hMenu):bDestroyed 


Destroys the menu specified by hMenu and frees any memory it 
occupied. 
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Destroy Window page 30 
Destroy Window(hWnd):bDestroyed 


Sends a WM_ DESTROY message to hWnd and frees any memory it 
occupied. 


DeviceMode _ see Update 
DeviceMode(hWnd,hltem,|pString,lpString):lpString 
Displays a dialog box that prompts user to set printer modes. 
Dialog Box page 40 
DialogBox(h/nstance,lp TemplateName,hWndParent,lpDialogFunc):nResult 


Creates a modal dialog box. 
DispatchMessage page 17 
DispatchMessage(/pMsg):lResult 


Passes message to window function of window specified in MSG 
structure. 


DigDirList page 41 
DigDirList(hDlg,lpPathSpec,nIDListBoz,nIDStaticPath, wFiletype):nListed 
Fills nJDListBox with names of files matching path specification. 

DigDirSelect page 43 
DigDirSelect(hDlg,lpString,nIDListBox):bDirectory 
Copies current selection from nIDListBoz to IpString. 

DPtoLP page 188 
DPtoLP(hDO,|pPoints,nCount):bConverted 


Converts into logical points the nCount device points given by 
lpPoints. 


Drawlcon _—ipage 122 
DrawlIcon(hDC,X, Y,hIcon):bDrawn 


Draws an icon with its upper left corner at X, Y. 


12 


Windows Functions 


DrawMenuBar page 65 
DrawMenuBar(h Wnd) 


Redraws the menu bar. 


Draw Text page 119 
DrawText(hDC,lpString,nCount,lpRect, wF ormat) 


Draws nCount characters of lpString in format specified by wk ormat, 
using current text and background colors. Clips output to rectangle 
given by /pRect. 


Ellipse page 113 
Ellipse(hDC,X1, Y1,X2, Y2):bDrawn 


Draws ellipse with center at the center of the given bounding rectan- 
gle. Draws border with current pen. Fills interior with current brush. 


Empty Clipboard page 48 
EmptyClipboard( ):bEmptied 


Empties clipboard, frees data handles, and assigns clipboard ownership 
to the window that currently has the clipboard open. 


EnableMenultem page 66 
EnableMenultem(hMenu, wIDEnableltem,wEnable):bEnabled 
Enables, disables, or grays a menu item, depending on wknable. 
EnableWindow page 60 
Enable Window(h Wnd, bEnable):bDone 


Enables and disables mouse and keyboard input to the specified 
window. 


EndDialog page 41 
EndDialog(hDig,nResult) 


Frees resources and destroys windows associated with a modal dialog 
box. 
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EndPaint page 74 
EndPaint(hWnd,lpPaint) 


Marks the end of window repainting; required after each BeginPaint 
call. 


EnumChildWindows page 38 
EnumChildWindows(h WndParent,lpEnumFunc,lParam):bDone 


Enumerates the child style windows belonging to hWndParent by pass- 
ing each child window handle and /Param to the lpEnumF unc function. 


EnumClipboardFormats page 53 
EnumClipboardFormats(wFormat):wNeztF ormat 


Enumerates formats from list of available formats belonging to the 
clipboard. 


EnumFonts page 180 
EnumFonts(hDC,lpFacename,!pFontF'unc,lpData):nResult 


Enumerates fonts available on a given device, passing font information 
through [pData to IlpFontF unc function. 


EnumObjects page 181 
EnumObjects(hDC,n Object Type,lpObjectFunc,lpData):nResult 


Enumerates pens or brushes (depending on nObject Type) available on a 
device, passing object information through /[pData to lpObjectFunc 
function. 


EnumProps page 83 
EnumProps(hWnd,lpEnumFunc):nResult 


Passes each property of hWnd, in turn, to the lpEnumFunc function. 
EnumWindows page 37 
Enum Windows(!pEnumFunc,!Param):bDone 


Enumerates windows on the screen by passing handle of each tiled, 
iconic, popup, and hidden popup window (in that order) to the 
lpEnumF unc function. 
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EqualRgn page 163 
EqualRgn(hSrcRgn1,hSrcRgn2):bEqual 
Checks the two given regions to determine if they are identical. 
Escape sipage 171 
Escape(hDC,nEscape,nCount,lpInData,lpOutData):nResult 


Accesses device facilities not directly available through GDI. 


Escape page 176 
Escape(hDC,ABORTDOC,nCount,lpInData,lpOutData):nResult 
Aborts the current job. [p/nData, lpOutData, and nCount are not used. 


Escape page 177 
Escape(hDC,DRAFTMODE,nCount,lpInData,lpOutData):nResult 


Turns draft mode off or on. [pInData points to 1 (on) or 0 (off). nCount 
is number of bytes at [pJnData. IpOutData is not used. 


Escape page 173 
Escape(hDC,ENDDOC,nCount,lpInData,lpOutData):nResult 
Ends print job started by STARTDOC. nCount, lpInData, lpOutData 


are not used. 


Escape page 179 
Escape(hDC,FLUSHOUTPUT, nCount,lpInData,lpOutData):nResult 


Flushes output in device buffer; lp/nData, lpOutData, and nCount are 
not used. 


Escape page 178 
Escape(hDC,GETCOLORTABLE, nCount,lpInData,lpOutData):nResult 


Copies RGB color table entry to lpOutData. lpInData is color table 
index. nCount is not used. 


Escape i page 178 
Escape(hDC,GETPHYSPAGESIZE, nCount,lpInData,lpOutData):nResult 


Copies physical page size to POINT structure at [pOutData. lpInData 
and nCount are not used. 
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Escape page 178 
Escape(hDC,GETPRINTINGOFFSET, nCount,lpInData,lpOu tData):nResult 


Copies printing offset to POINT structure at /pOutData. lpInData and 
nCount are not used. 


Escape page 179 
Escape(hDC,GETSCALINGFACTOR,nCount,lpInData,lpOutData):nResult 


Copies scaling factors to POINT structure at [pOutData. lpInData 
and nCount are not used. 


Escape page 174 
Escape(hDC,NEWFRAME,nCount,!pInData,lpOutData):nResult 
Ends writing to a page. nCount, [pInData, and [pOutData are not used. 


Escape page 174 
Escape(hDC,NEXTBAND,nCount,/pInData,lpOutData):nResult 


Ends writing to a band. /pOutData gives rectangle to hold device coor- 
dinates of next band. nCount and Ip/nData are not used. 


Escape page 179 
Escape(hDC,QUERYESCSUPPORT, nCount,lpInData,lpOutData):nResult 


Tests whether an escape is supported by device driver. lp/nData points 
to the escape. nCount is the number of bytes at lp/nData. IpOutData is 
not used. 


Escape page 175 
Escape(hDC,SETABORTPROC,nCount,/pInData,lpOutData):nResult 


Sets abort function for print job. lpInData, lpOutData, and nCount are 
not used. 


Escape page 178 
Escape(hDC,SETCOLORTABLE, n Count, lpInData,lpOu tData):nResult 


Sets RGB color table entry. lp/nData points to table index and color. 
lpOutData points to RGB color value to be set by device driver. 
nCount is not used. 
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Escape page 172 
Escape(hDC,STARTDOC,nCount,lpInData,lpOutData):nResult 


Starts print job, spooling NEWFRAME calls under same job until it 
reaches ENDDOC. IpInData is name of document; nCount is its length. 
lpOutData not used. 


EscapeCommF unction page 234 
EscapeCommF unction(nCid,nFunc):nResult 


Executes escape function nF'unc for communication device nCid. 


ExcludeClipRect page 160 
ExcludeClipRect(hDC,X1, Y1,X2, Y2):nRgnType 


Creates new clipping region from existing clipping region less the given 
rectangle. 


FatalExit page 225 
FatalExit( Code):Result 


Halts Windows and prompts through auxiliary port (AUX) for instruc- 
tions on how to proceed. 


FillRect page 126 

FillRect(hDC,lpRect,hBrush):nResult 

Fills given rectangle using the specified brush. 
FillRgn page 125 

FillRgn(hDC,hRgn,hBrush):bFilled 

Fills given region with brush specified by ABrush. 
FindAtom page 221 

FindAtom(!pString):wAtom 

Retrieves atom (if any) associated with character string [pString. 
FindResource page 212 

FindResource(h/nstance,lpName,|p Type):hResInfo 


Locates resource [pName having [pType and returns handle for access- 
ing and loading the resource. 
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Find Window page 85 
Find Window(lpClass Name,lp WindowName):hWnd 


Returns the handle of the window having the given class and caption. 


FlashWindow _ page 90 
Flash Window(h Wnd, binvert):bInverted 


Flashes the given window once by inverting its active/inactive state. 


FloodFill page 124 
FloodFill(hDC,X, Y,rgbColor):bFilled 


Fills area of the display surface with current brush, starting at X, Y 
and continuing in all directions to the boundaries with the given 
rgbColor. 


FlushComm page 233 
FlushComm(nCid,nQueue):nResult 


Flushes characters from nQueue of communication device nCid. 


FrameRect page 126 
FrameRect(hDC,lpRect,hBrush):nResult 


Draws border for the given rectangle using the specified brush. 


FrameRgn page 125 
FrameRgn(hDC,hRgn,hBrush,n Width, nHeight):bF ramed 


Draws border for given region using hBrush. nWidth is width of vertical 
brush strokes. nHezght is height of horizontal strokes. 


FreeLibrary page 194 
FreeLibrary(hLibModule) 


Removes library module hLibModule from memory if reference count is 
zero. 


FreeProcInstance page 194 
FreeProcInstance(IpProc) 


Removes the function instance entry at address lpProc. 
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FreeResource page 215 
FreeResource(hResData):bF reed 


Removes resource hResInfo from memory if reference count 1s zero. 
GetActive Window see Update 

GetActiveWindow():h Wnd 

Returns handle to the active window. 
GetAtomHandle _ see Update 

GetAtomHandle(wAtom):hMem 

Returns the handle (relative to the local heap) of the atom string. 
GetAtomName page 221 

GetAtomName(wAtom,/pBuffer,nSize):nLength 


Copies character string (up to nSize characters) associated with wAtom 


to IpBuffer. 


GetBitmapBits page 133 

GetBitmapBits(hBitmap,!Count,|pBits):|Copied 

Copies [Count bits of specified bitmap into buffer pointed to by (pBits. 
GetBitmapDimension page 134 

GetBitmapDimension(hBitmap):ptDimensions 

Returns the width and height of the bitmap specified by hBitmap. 
GetBkColor page 143 

GetBkColor(hDC):rgbColor 

Returns the current background color of the specified device. 
GetBkMode page 144 

GetBkMode(hDC):nBkMode 


Returns the background mode of the specified device. 
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GetBrushOrg page 158 
GetBrushOrg(hDC):dwOrigin 


Retrieves the current brush origin for the given display context. 


GetBValue page 244 
GetBValue(rgbColor):cBlue 


Retrieves the blue value of the given color. 


GetCaretBlinkTime page 95 
GetCaretBlinkTime( ):wMSeconds 


Returns the current caret flash rate. 


GetClassLong page 23 
GetClassLong(h Wnd,nIndez):long 
Retrieves information at nIndez in the WNDCLASS structure. 


GetClassName page 22 
GetClassName(h Wnd,lp Class Name,nMazCount):n Copied 


Copies hWnd’s class name (up to nMazCount characters) into 
lpClassName. 


GetClassWord page 23 
GetClassWord(hWnd,nIndez): word 
Retrieves information at nIndez in the WNDCLASS structure. 


GetClientRect page 85 

GetClientRect(hWnd,lpRect) 

Copies client coordinates of the window client area to IpRect. 
GetClipboardData _ page 51 

GetClipboardData(wF ormat):hClipData 


Retrieves data from the clipboard in the format given by wFormat. 


20 


Windows Functions 


GetClipboardFormatName page 53 
GetClipboardFormatName(wFormat,lpFormatName,nMazCount):n Copied 


Copies wFormat’s format name (up to nMazCount characters) into 
lpFormatName. 


GetClipboardOwner page 48 
GetClipboardOwner( ):hWnd 


Retrieves the window handle of the current owner of the clipboard. 


GetClipboard Viewer page 54 
GetClipboardViewer( ):hWnd 


Retrieves the window handle of the first window in the clipboard 
viewer chain. 


GetClipBox page 159 
GetClipBox(hDC,/pRect):nRgn Type 


Copies dimensions of bounding rectangle of current clip boundary to 
lpRect. 


GetCodeHandle page 193 
GetCodeHandle(lpF'unc):hinstance 


Retrieves the handle of the code segment containing the given 
function. 


GetCommError page 229 
GetCommError(nCid,lpStat):nError 


Fills buffer /pStat with communication status of device nCid. Returns 
error code, if any. 


GetCommEventMask page 232 
GetCommEventMask(nCid,nEvtMask):wEvent 


Retrieves, then clears, event mask. 
GetCommState page 229 
GetCommState(nCid,/pDCB):nResult 


Fills buffer lpDC'B with the device control block of communication 
device nCid. 
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GetCurrentPosition page 111 
GetCurrentPosition(hDC):ptPos 


Retrieves the logical coordinates of the current position. 


GetCurrent Task page 206 
GetCurrentTask( ):hTask 


Returns task handle of the current task. 


GetCurrentTime _ page 15 
GetCurrentTime( ):/Time 


Returns the time elapsed since the system was booted to the current 
time. 


GetCursorPos page 92 
GetCursorPos(IpPoint) 


Stores mouse cursor position, in screen coordinates, in POINT 
structure. 


GetDC page 70 
GetDC(hWnd):hDC 


Retrieves the display context for the client area of the specified 
window. 


GetDeviceCaps page 183 

GetDeviceCaps(hDC,nJIndez):n Value 

Retrieves the device-specific information specified by nJndez. 
GetDlgItem page 43 

GetDlglItem(hDlg,nIDDigItem):hCtl 


Retrieves the handle of a dialog item (control) from the given dialog 
box. 
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GetDligIltemInt page 44 
GetDigltemInt(hDig,nIDDigltem,lp Translated, bSigned):wValue 


Translates text of nJDDigItem into integer value. Value at [p Translated 
is zero if errors occur. bSigned is nonzero if minus sign might be 
present. 


GetDlgItem Text page 45 
GetDigltemText(hDlg,nIDDigltem,lpString,nMazCount):n Copied 


Copies nIDDiglItem’s control text (up to nMazCount characters) into 
lpString. 


GetDoubleClickTime _ see Update 
GetDoubleClickTime( ): wClickTime 


Retrieves the current double-click time of the system mouse. 


GetEnvironment page 186 
GetEnvironment(/pPortName,lpEnviron,nMazCount):n Copied 


Copies to /pEnviron environment associated with device attached to 
given port. 


GetFocus page 56 
GetFocus( ):hWnd 


Retrieves the handle of the window currently owning the input focus. 


GetGValue page 244 
GetGValue(rgbColor): cGreen 


Retrieves the green value of the given color. 
GetInstanceData page 192 | 
GetInstanceData(hI/nstance,pData,nCount):nBytes 


Copies nCount bytes of data from offset pData in instance hInstance to 
same offset in current instance. 


GetKeyState page 56 
GetKeyState(n VirtKey):nState 
Retrieves the state of the virtual key specified by nVirtKey. 
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GetMapMode page 151 
GetMapMode(hDC):nMapMode 


Retrieves the current mapping mode. 


GetMenu page 62 
GetMenu(hWnd):hMenu 


Retrieves a handle to the menu of the specified window. 


GetMenuString page 69 
GetMenuString(hMenu,wlDItem,|pString,nMazCount, wFlag):n Copied 


Copies wlDItem’s menu label (up to nMazCount characters) into 


lpString. wFlag is MF_ BYPOSITION or MF_ BYCOMMAND. 


GetMessage page 10 
GetMessage(!pMsg,h Wnd,wMsgFilterMin, wMsgFilterMaz):bContinue 


Retrieves message in range wMsgFilterMin to wMsgFilterMaz; stores at 
lpMsg. 


GetMessagePos page 14 
GetMessagePos( ):dwPos 


Returns mouse position, in screen coordinates, at the time of the last 
message retrieved by GetMessage. 


GetMessageTime page 14 
GetMessageTime( ):/Time 


Returns the message time for the last message retrieved by 
Get Message. 


GetMetaFile page 169 
GetMetaFile(lpFilename):hMF 
Creates a handle for the metafile named by /[pFilename. 
GetMetaFileBits page 170 
GetMetaFileBits(hMF):hMem 


Stores specified metafile as collection of bits in global memory block. 
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GetModuleFileName page 191 
GetModuleFileName(hModule,lpFilename,nSize):nLength 
Copies module filename (up to nSize characters) to [pFilename. 
GetModuleHandle page 191 
GetModuleHandle(/pModuleName):hModule 
Returns module handle of module named by [pModuleName. 
GetModuleUsage page 191 
GetModuleUsage(hModule):nCount 
Returns reference count of module hModule. 
Get NearestColor page 187 
GetNearestColor(hDC,rgbColor):rgbSolidColor 
Returns the device color closest to rgbColor. 
GetObject page 140 
GetObject(hObject,nCount,lpObject):n Copied 
Copies nCount bytes of logical data defining hObject to lpObject. 
GetParent page 85 
GetParent(hWnd):hWndParent 


Retrieves the window handle of the specified window’s parent (if any). 
GetPixel page 123 


GetPixel(hDC,X, Y):rgbColor 


= the RGB color value of the pixel at the point specified by X 
and Y. 


GetPolyFillMode page 148 
GetPolyFillMode(hDC):nPolyFillMode 


Retrieves the current polygon-filling mode. 
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GetProcAddress page 192 
GetProcAddress(hModule,lpProcName):lpAddress 


ig address of the function named by [pProcName in module hMo- 
dule. 


GetProfileInt page 222 
GetProfileInt(/pSectionName,lpKeyName,nDefault):nKey Value 


Returns integer value named by /pKeyName in section IpSectionName 
from the win.inz file. If name or section not found, nDefault is returned. 


GetProfileString page 223 


GetProfileString(/pSectionName,lpKeyName,|pDefault,lpReturnedString, 
nSize):nLength 


Returns character string named by /pKeyName in section [pSection- 
Name from the win.ini file. String is copied (up to nSize characters) to 
lpReturnedString. If name or section are not found, lpDefault is 
returned. 


GetProp _ page 82 
GetProp(hWnd,!lpString):hData 


Retrieves data handle associated with IpString from window property 
list. 


GetRelAbs page 142 
GetRelAbs(hDC):nRelAbsMode 
Retrieves the relabs flag. 

GetROP2 page 145 
GetROP2(hDC):nDrawMode 
Retrieves the current drawing mode. 

GetRValue page 244 
GetRValue(rgbColor): cRed 


Retrieves the red value of the given color. 
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GetScrollPos page 79 
GetScrollPos(hWnd,nBar):nPos 


Retrieves current position of scroll bar elevator identified by hWnd and 
nBar. 


GetScrollRange page 81 
GetScrollRange(hWnd,nBar,lpMinPos,l|pMazPos) 


Copies minimum and maximum scroll bar positions for given scroll bar 
to lpMinPos and lpMazPos. 


GetStockObject page 127 
GetStockObject(nIndez):hObject 


Retrieves a handle to a predefined stock pen, brush, or font. 


GetStretchBltMode page 147 
GetStretchBltMode(hDC):nStretchMode 


Retrieves the current stretching mode. 


GetSubMenu page 68 
GetSubMenu(hMenu,nPos):hPopupMenu 


Retrieves the menu handle of the popup menu at the given position in 
Menu. 


GetSysColor page 101 
GetSysColor(nJndez):rgbColor 


Retrieves the system color identified by n/ndez. 
GetSysModalWindow page 86 

GetSysModalWindow():h Wnd | 

Returns the handle of a system-modal window, if one is present. 
GetSystemMenu page 68 

GetSystemMenu(h Wnd, bRevert):hSysMenu 


Allows access to the System menu for copying and modification. 
bRevert is nonzero to restore the original System menu. 
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GetSystemMetrics page 100 
GetSystemMetrics(n/ndez):n Value 


Retrieves information about the system metrics identified by nIndez. 


GetTempDrive page 248 
GetTempDrive(cDriveLetter):cOptDriveLetter 


Returns letter for the optimal drive for a temporary file. cDriveLetter is 
a proposed drive. 


GetTempFileName page 248 


GetTempFileName(cDriveLetter,lpPrefizString, wUnique, 
lp TempFileName):wUniqueNumber 


Creates a temporary filename. 

Get TextCharacterExtra page 167 
GetTextCharacterExtra(hDC):nCharExztra 
Retrieves the current intercharacter spacing. 

Get TextColor page 144 
GetTextColor(hDC):rgbColor 


Retrieves the current text color. 


Get TextExtent page 166 
GetTextExtent(ADC,lpString,nCount):dwTextExtents 


Uses current font to compute width and height of text line given by 
lpString. 


Get TextF ace page 182 
GetTextFace(hDC,nCount,lpFacename):nCopied 


Copies the current font’s facename (up to nCount characters) into 
lpFacename. 


Get TextMetrics page 183 
GetTextMetrics(hDC,lpMetrics):bRetrieved 


Fills buffer given by /[pMetrics with metrics for currently selected font. 
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GetThresholdEvent _ page 241 
GetThresholdEvent( ):/p/nt 


Returns long pointer to a threshold flag. The flag is set if any voice 
queue is below threshold (i.e., below a given number of notes). 


GetThresholdStatus _ page 241 
GetThresholdStatus( ):fStatus 


Returns a bit mask containing the threshold event status. If a bit is 
set, the given voice queue is below threshold. 


GetUpdateRect page75 
GetUpdateRect(hWnd,lpRect,bErase):bUpdate 


Copies dimensions of bounding rectangle of window region that needs 
updating to lpRect. bErase is nonzero if background needs erasing. 
bUpdate is zero if window is up-to-date. 


Get Version page 195 
GetVersion( ):wVersion 


Returns the current version of Windows. 


Get ViewportExt page 158 
Get ViewportExt(hDC):ptEztents 


Retrieves the z- and y-extents of the display context’s viewport. 


Get ViewportOrg page 154 
Get ViewportOrg(hDC):ptOrigin 


Retrieves z- and y-coordinates of the origin of the display context’s 
viewport. 


Get WindowDC page 72 
Get WindowDC(hWnd):hDC 


Retrieves display context for entire window, including caption bar, 
menus, scroll bars. 
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GetWindowExt page 153 
Get WindowExt(hDC):ptEztents 


Retrieves z- and y-extents of the display context’s window. 


Get WindowLong page 31 
Get WindowLong(hWnd,nIndez):long 


Retrieves information identified by nIndez about the given window. 


GetWindowOrg page 151 
Get Window Org(hDC):ptOrigin 


Retrieves z- and y-coordinates of the origin of the display context’s 
window. 


GetWindowRect page 86 
Get WindowRect(h Wnd,lpRect) 


Copies dimensions, in screen coordinates, of entire window (including 
caption bar, border, menus, and scroll bars) to IpRect. 


GetWindowText page 84 
Get Window Text(hWnd,lpString,nMazCount):n Copied 


Copies h Wnd’s window caption (up to nMazCount characters) into 
lpString. 


Get Window TextLength page 84 

Get WindowTextLength(hWnd):nLength 

Returns the length of the given window’s caption or text. 
Get Window Word page 30 

Get Window Word(h Wnd,nJIndez): word 

Retrieves information identified by nIndez about the given window. 
GlobalAlloc page 196 

GlobalAlloc(wFlags,dwBytes):hMem 


Allocates dwBytes of memory from the global heap. Memory type (e.g., 
fixed or moveable) is set by wFlags. 


30 


Windows Functions 


GlobalCompact __ page 197 

GlobalCompact(dwMinF ree):dwLargest 

Compacts global memory to generate dwMinFree free bytes. 
GlobalDiscard page 197 

GlobalDiscard(hMem):hOldMem 

Discards global memory block hMem if reference count is zero. 
GlobalFlags page 200 

GlobalFlags(hMem):wFlags 

Returns memory type of global memory block hMem. 
GlobalF ree page 197 

GlobalFree(hMem):hOldMem 


Removes global memory block hMem from memory if reference count is 
zero. 


GlobalHandle see Update 
GlobalHandle(wMem): dwMem 


Retrieves the handle of the global memory object whose segment 
address is wMem. 


GlobalLock _ page 198 
GlobalLock(hMem):lpAddress 


Returns address of global memory block hMem, locks block in memory, 
and increases the reference count by one. 


GlobalReAlloc page 198 
GlobalReAlloc(hMem, dwBytes, wFlags):hNewMem. 


Reallocates the global memory block hMem to dwBytes and memory 
type wFlags. 


GlobalSize page 199 
GlobalSize(hMem):dwBytes 
Returns the size, in bytes, of global memory block hMem. 
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GlobalUnlock page 200 
GlobalUnlock(hMem):bResult 


Unlocks global memory block hMem and decreases the reference count 
by one. 


GrayString page 121 


GrayString(hDC,hBrush,lpOutputFunc,lpData,nCount,X, Y, 
nWidth,nHeight):bDrawn 


Writes nCount characters of string at X, Y, using lpOutputF unc (or 
TextOut if NULL). Grays text using ABrush. lpData specifies output 
string (if lpOutputFunc is NULL) or data are passed to output func- 
tion. nWidth and nHezght give dimensions of enclosing rectangle (if 
zero, dimensions are calculated). 


HIBY TE page 242 

HIBY TE(nI/nteger):cHighByte 

Returns the high-order byte of nJnteger. 
HideCaret page 94 

HideCaret(h Wnd) 


Removes system caret from the given window. 
HiliteMenultem __ page 67 


HiliteMenultem(hWnd,hMenu, wlDHiltteltem, wHilite):bHilited 


Highlights or removes the highlighting from a top-level (menu bar) 
menu item. 


HIWORD page 243 
HIWORD(lInteger): wHigh Word 
Returns the high-order word of lnteger. 
InflateRect page 98 
InflateRect(/pRect,X, Y):nResult 


Expands or shrinks the rectangle specified by IpRect by X units on the 
left and right ends of the rectangle and Y units on the top and bottom. 
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InitAtom Table page 219 
InitAtomTable(nSize):bResult 


Initializes atom hash table and sets it to nSize atoms. 


InSendMessage _ see Update 
InSendMessage():b/nSend 


Returns TRUE if window function is processing a message sent with 
Send Message. 


IntersectClipRect page 159 
IntersectClipRect(hDC,X1, Y1,X2, Y2):nRgnType 


Forms new clipping region from intersection of current clipping region 
and given rectangle. 


IntersectRect page 98 
IntersectRect(lpDestRect,lpSrce1Rect,lpSrc2Rect):nIntersection 
Finds the intersection of two rectangles and copies it to lpDestRect. 
InvalidateRect page 75 
InvalidateRect(h Wnd,lpRect,bErase) 


Marks for repainting the rectangle specified by /pRect (in client coordi- 
nates). The rectangle is erased if bErase is nonzero. 


InvalidateRgn page 76 

InvalidateRgn(h Wnd,hRgn, bErase) 

Marks hRgn for repainting. The region is erased if bErase is nonzero. 
InvertRect page 127 

InvertRect(hDC,lpRect):nResult , 

Inverts the display bits of the specified rectangle. 
InvertRgn _—i page 126 

InvertRgn(hDC,hRgn):bInverted 

Inverts the colors in the region specified by hRgn. 
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IsChild — see Update 
IsChild(hParent Wnd,hWnd):bChild 
Returns TRUE if given window is a child of hParent Wnd. 


IsClipboardFormatAvailable — see Update 
IsClipboardFormatAvailable(wFormat):bAvailable 
Returns TRUE if data in given format is available. 


IsDialogMessage _ page 40 
IsDialogMessage(hDlg,!pMsqg):bUsed 


Determines whether /[pMsgq is intended for the given modeless dialog 
box. If so, the message is processed and 6Used is nonzero. 


IsDlgButtonChecked _ page 45 
IsDlgButtonChecked(hDlg,nIDButton):wCheck 


Tests whether n/JDButton is checked. For a 3-state button, returns 2 
for grayed, 1 for checked, zero for neither. 


IsIconic page 37 

IsIconic(h Wnd):blconic 

Specifies whether or not a window is open or closed (iconic). 
IsRectEmpty page 99 

IsRectEmpty(/pRect):bEmpty 

Determines whether or not the specified rectangle is empty. 
Is Window page 29 

IsWindow(h Wnd):bEzists 


Determines whether or not hWnd is a valid, existing window. 
IsWindowEnabled page 61 
IsWindowEnabled(h Wnd):bEnabled 


Specifies whether or not hWnd is enabled for mouse and keyboard 
input. 
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IsWindowVisible page 36 
IsWindowVisible(h Wnd):b Visible 


Determines whether or not the given window is visible on the screen. 


KillTimer __ page 60 
Kill Timer(h Wnd,nJDEvent):bKilled 
Kills the timer event identified by hWnd and nlDEvent. 


LineDDA page 124 
LineDDA(X1, Y1,X2, Y2,lpLineFunc,|pData) 


Computes successive points in line starting at X1, Y1 and ending 
at X2, Y2, passing each point and /pData parameter to [pLineF'unc 
function. 


LineTo page 111 
LineTo(hDC,X, Y):bDrawn 


Draws line with current pen from the current position up to, but not 
including, the point X, Y. 


LoadAccelerators page 212 
LoadAccelerators(hInstance,lp TableName):hRes 
Loads accelerator table named by lp TableName. 


LoadBitmap page 209 
LoadBitmap(hJnstance,lpBitmapName):hBitmap 
Loads bitmap resource named by l[pBitmapName. 

LoadCursor page 209 
LoadCursor(h/nstance,lpCursorName):hCursor ° 
Loads cursor resource named by [pCursorName. 

LoadIcon __spage 210 
LoadIcon(hInstance,lpIconName):hIcon 


Loads icon resource named by [pIconName. 
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LoadLibrary page 194 
LoadLibrary(lpLibFileName):hLibModule 
Loads the library module named by IpLibFilename. 


LoadMenu page 211 
LoadMenu(hlnstance,lpMenuName):hMenu 


Loads menu resource named by [pMenuName. 


LoadResource page 214 
LoadResource(hlnstance,hResInfo):hResData 


Loads the resource hResInfo and returns a handle to the resource. 


LoadString page 212 
LoadString(h/nstance, wID,lpBuffer, nBufferMaz):nSize 


Loads string resource wID into the buffer [pBuffer. Up to nBufferMax 
characters are copied. 


LOBYTE page 242 
LOBYTE(nJnteger):cLowByte 
Returns the low-order byte of nInteger. 


LocalAlloc page 200 
LocalAlloc(wFlags,wBytes):hMem 


Allocates wBytes of memory from the local heap. Memory type (e.g., 
fixed or moveable) is set by wFlags. 


LocalCompact page 201 
LocalCompact(wMinF ree): wLargest 


Compacts local memory to generate wMinFree free bytes. 


LocalDiscard page 202 
LocalDiscard(hMem):hOldMem 


Discards local memory block hMem if reference count is zero. 
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LocalF lags page 206 
LocalFlags(hMem):wFlags 


Returns memory type of local memory block hMem. 


LocalF ree page 202 
LocalFree(hMem):hOldMem 


Frees local memory block hMem from memory if reference count is 
zero. 


LocalF reeze page 202 
LocalFreeze( Dummy) 


Prevents compaction of the local heap. 


LocalHandle see Update 
LocalHandle(wMem):hMem 


Retrieves the handle of the local memory object whose address is 
wMem. 


LocalHandleDelta page 205 
LocalHandleDelta(nNewDelta):nCurrentDelta 


Sets the entry count for each new handle table created in the local 
heap. 


Locallnit see Update 
Locallnit(wValue,pString,pString):bResult 


Initializes the local heap. 
LocalLock _ page 202 
LocalLock(hMem):pAddress 


Returns the address of local memory block hMem, locks the block in 
memory, and increases the reference count by one. 


LocalMelt page 203 
LocalMelt( Dummy) 


Permits compaction of the local heap. 
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LocalNotify — see Update 
LocalNotify(/pF'unc):lpPrevFunc 


Sets the callback function for handling notification messages from 
local memory. 


LocalReAlloc page 203 
LocalReAlloc(hMem, wBytes,wFlags):hNewMem 


Reallocates the local memory block hMem to wBytes and memory type 
wk lags. 


LocalSize page 204 
LocalSize(hMem):wBytes 


Returns the size, in bytes, of local memory block hMem. 


LocalUnlock page 205 
LocalUnlock(hMem):bResult 


Unlocks local memory block hMem and decreases the reference count 
by one. 


LockData page 205 
LockData(Dummy):hMem 
Locks the data segment in memory. 
LockResource page 214 
LockResource(hResInfo):lpResInfo 


Returns the memory address of the resource hResInfo, locks the 
resource in memory, and increases the reference count by one. 


LockSegment Function see Update 

LockSegment( wSegment):hSegment 

Locks the segment whose segment address is wSegment. 
LOWORD page 243 

LOWORD(lInteger):wLowWord 


Returns the low-order word of lnteger. 
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LPtoDP page 188 
LPtoDP(hDC,lpPoints,nCount):bConverted 
Converts logical points into device points. 
MAKEINTATOM page 221 
MAKEINTATOM(winteger):nAtom 
Casts an integer for use as an argument to AddAtom. 
MAKEINTRESOURCE page 243 
MAKEINTRESOURCE(n/nteger):lpIntegerID 
Casts an integer for use as an argument in AddAtom. 
MAKELONG page 243 
MAKELONG(nLowWord,nHighWord):dwinteger 
Creates an unsigned long integer. 
MAKEPOINT page 244 
MAKEPOINT(IValue):ptPoint 
Converts a long value into a POINT structure. 


MakeProclInstance page 193 
MakeProcInstance(/pProc,hInstance):lpAddress 


Returns a function instance address for function lpProc. Calls to the 
instance address ensure that the function uses the data segment of 
instance Alnstance. 


MapDialogRect page 47 
MapDialogRect(hDlg,lpRect) 


Converts the dialog box coordinates given in l[pRect to client 
coordinates. 


max page 245 
max(A,B):nMazimum 


Returns the maximum value of A and B. 
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MessageBeep page 89 
MessageBeep(wType):bBeep 


Generates a beep at the system speaker when a message box is 
displayed. 


MessageBox page 87 
MessageBox(hWndParent,lp Tezt,lp Caption, wType):nMenultem 


Creates window with given /[pTezt and IpCaption containing the 
predefined icons and push buttons defined by wT ype. 


min page 244 

min(A,B):nMinimum 

Returns the minimum value of A and B. 
MoveTo page 110 


MoveTo(hDC,X, Y):ptPrevPos 
Moves the current position to the point specified by Xand Y. 


Move Window page 35 
MoveWindow(h Wnd,X, Y,n Width, nHeight, bRepaint) 
Causes WM_SIZE message to be sent to hWnd. X, Y, nWidth, and 


nHeight give the new size of the window. | 


OemToAnsi page 218 
OemToAnsi(lpOemStr,lpAnsiStr):b Translated 
Converts the OEM character string to an ANSI string. 


OffsetClipRgn page 160 
OffsetClipRgn(hDC,X, Y):nRgn Type 


Moves clipping region X units along the z-axis and Y units along the 
y-axis. 


OffsetRect page 99 
OffsetRect(IpRect,X, Y):nResult 


Moves given rectangle X units along the z-axis and Y units along the 
y-axIs. 
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OffsetRgn page 163 
OffsetRgn(hRgn,X, Y):nRgnType 


Moves the given region X units along the zaxis and Y units along the 
y-axis. 


OpenClipboard __ page 47 
OpenClipboard(hWnd):bOpened 


Opens clipboard; prevents other applications from modifying its 
contents. 


OpenComm page 225 
OpenComm(IpComName, win Queue, wOutQueue):n Cid 


Opens communication device named by [pCommName. ‘Transmit-queue 
and receive-queue sizes are set by winQueue and wOutQueue. 


OpenF ile page 245 

OpenFile(lpFileName,lpReOpenBuff, wStyle):nFile 

Creates, opens, reopens, or deletes file named by IpFuleName. 
Openlcon sipage 34 

OpenIcon(h Wnd):bOpened 


Opens the specified window. 
OpenSound page 235 

OpenSound( ):n Voices 

Opens the play device for exclusive use. 
PaintRgn page 126 

PaintRgn(hDC,hRgn):bFilled . 

Fills the region specified by hRgn with the currently selected brush. 
PatBlt page 115 

PatBlt(hDC,X, Y,n Width, nHeight,dwRop):bDrawn 


Creates a bit pattern on the specified device, using dwRop to combine 
the current brush with the pattern already on the device. 
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PeekMessage page 12 
PeekMessage(/pMsg,h Wnd,wMsgFilterMin, wMsgF ilterMaz, bRemoveMsg):bPresent 
Checks application queue and places message (if any) at [pMsg. 

Pie pagell5 
Pie(ADC,X1, Y1,X2, Y2,X3, Y3,X4, Y4):bDrawn 


Draws arc starting at X8, Y8 and ending at X4, Y4 and connects 
center and two endpoints, using current pen. Moves counterclockwise. 


Fills with current brush. Arc’s center is center of bounding rectangle 
given by X1, Y1, X2, Y2. 


PlayMetaFile page 170 

PlayMetaFile(hDC,hMF):bPlayed 

Plays the contents of the specified metafile on the given device context. 
Polygon page 113 

Polygon(hDC,!pPoints,nCount):bDrawn 

Draws a polygon by connecting the nCount vertices given by /pPoznts. 
Polyline page 111 

Polyline(ADC,!pPoints,nCount):bDrawn 


Draws a set of line segments, connecting the nCount points given by 
lpPoints. 


PostAppMessage page 19 

PostAppMessage(h Task, wMsg,wParam,!Param):bPosted 

Posts message to application; returns without waiting for processing. 
PostMessage page 18 

PostMessage(h Wnd,wMsg,wParam,|Param):bPosted 


Places message in application queue; returns without waiting for 
processing. 


PostQuit Message page 10 
Post QuitMessage(nFzitCode) 


Posts a WM_ QUIT message to the application and returns immedi- 
ately. 
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PtInRect page 99 

PtInRect(ipRect,Point):bInRect 

Indicates whether or not a specified point lies within a given rectangle. 
PtInRegion page 165 

PtInRegion(hFRgn,X, Y):bSuccess 

Tests if X, Y is within the given region. 
PtVisible page 161 

PtVisible(hDC,X, Y):b Visible 

Tests if X, Y is within the clipping region of the given display context. 
ReadComm page 227 

ReadComm(nCid,!pBuf,nSize):nBytes 


Reads up to nSize bytes from the communication device nCid into 
buffer [pBuf. 


Rectangle page 112 
Rectangle(hDC,X1, Y1,X2, Y2):bDrawn 


Draws rectangle, using current pen for border and current brush for 


filling. 
RectVisible page 161 
Rect Visible(hDC,lpRect):b Visible 
Determines if any part of given rectangle lies within clipping region. 


RegisterClass page 22 
RegisterClass(lp WndClass):bRegistered 


Registers a window class. 


RegisterClipboardFormat page 52 
RegisterClipboardFormat(/pFormatName):wF ormat 


Registers a new clipboard format whose name is pointed to by 
lpFormatName. 
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RegisterWindowMessage page 19 
Register WindowMessage(/pString):wMsq 


Defines a new window message that is guaranteed to be unique. 


ReleaseCapture page 59 
ReleaseCapture( ) 


Releases mouse input and restores normal input processing. 


ReleaseDC page 73 
ReleaseDC(hWnd,hDC):nReleased 
Releases a display context when an application is finished drawing in 
it. 
RemoveF ontResource page 208 
RemoveF ontResource(lpFilename):bSuccess 


Removes from the font table the font resource named by IpFilename. 


RemoveProp page 82 
RemoveProp(hWnd,lpString):hData 


Removes /[pString from property list; retrieves corresponding 
data handle 


ReplyMessage ss page 19 
ReplyMessage(/Reply) 


Replies to message without returning control to the SendMessage 
caller. 


RestoreDC page 110 
RestoreDC(hDC,nSavedDC):bRestored 


Restores display context given by ADC to previous state given by 
nSavedDC. 


RGB __ see Update 
RGB(r,g,b):D WORD 


Creates an RGB color value from individual red, green, and blue 
values. 
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RoundRect page 112 
RoundRect(hDC,X1, Y1,X2, Y2,X8, Y3):bDrawn 


Draws rounded rectangle, using current pen for border, current brush 
for filling. 


SaveDC page 109 
SaveDC(hADC):nSavedDC 
Saves the current state of the display context hDC. 


Screen ToClient page 96 
Screen ToClient(hWnd,lpPoint) 


Converts the screen coordinates at /[pPoint to client coordinates. 


ScrollWindow page 77 
ScrollWindow(hWnd,XAmount, YAmount,lpRect,lpClipRect) 


Moves contents of client area XAmount along screen’s z-axis and 
YAmount units along y-axis (right for positive XAmount; down for 
positive YAmount). 


SelectClipRgn page 139 
SelectClipRgn(hDC,hRgn):nRgnType 


Selects given region as current clipping region for the specified display 
context. 


SelectObject page 138 
SelectObject(hDC,hObject):hOldObject 


Selects hObject as current object, replacing previous object of same 
type. 


SendDlgItemMessage _ page 46 
SendDlgltemMessage(hDig,nJDDigItem,wMsg,wParam,!Param):lResult 
Sends a message to nJDDigItem within the dialog box specified by hDig. 

SendMessage page 17 
SendMessage(hWnd,wMsg,wParam,!Param):lReply 


Sends a message to a window or windows. 
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SetActive Window page 36 
SetActiveWindow(hWnd):hWndPrev 


Makes a tiled or popup style window the active window. 


SetBitmapBits page 133 
SetBitmapBits(hBitmap, dwCount,lpBits):bCopied 


Sets bitmap bits to values given at lpBits. dwCount is byte count at 
lpBits. 


SetBitmapDimension page 133 
SetBitmapDimension(hBitmap,X, Y):ptOldDimensions 


Associates a width and height, in 0.1 millimeter units, with a bitmap. 


SetBkColor page 142 
SetBkColor(hDC,rgbColor):rgbOldColor 


Sets current background color to the device color closest to rgbColor. 


SetBkMode page 143 
SetBkMode(hDC,nBkMode):nOldBkMode 


Sets the background mode used with text, hatched brushes, and line 
styles. 


SetBrushOrg page 158 
SetBrushOrg(hDC,X, Y):dwOldOrigin 


Sets the origin of all brushes selected into the given display context. 


SetCapture page 58 
SetCapture(hWnd):hWndPrev 


Causes mouse input to be sent to hWnd, regardless of mouse cursor 
position. 


SetCaretBlinkTime page 95 
SetCaretBlink Time(wMSeconds) 
Establishes the caret flash rate. 
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SetCaretPos page 94 
SetCaretPos(X;, Y) 
Moves the caret to the position specified by X and Y. 


SetClassLong page 24 
SetClassLong(hWnd,nIndez,!NewLong):!OldLong 
Replaces long value at nIndez in the WNDCLASS structure. 


SetClassWord _ page 24 
SetClassWord(hWnd,nIndez,wNewWord):wOldWord 
Replaces word at the given nIndez in the WNDCLASS structure. 


SetClipboardData _ page 48 
SetClipboardData(wF ormat,hMem):hClipData 


Copies hMem, a handle for data having wFormat format, into the 
clipboard. 


SetClipboard Viewer page 54 
SetClipboardViewer(hWnd):hWndNezt 


Adds hWnd to clipboard viewer chain. hWndNezt is next window in 
chain. 


SetCommBreak page 233 
SetCommBreak(nCid):nResult 


Sets a break state on communication device nCid and suspends charac- 
ter transmission. 


SetCommEventMask page 231 
SetCommEventMask(nCid,nEvtMask):lpEvent : 


Sets the event mask of the communication device nCid. 


SetCommState page 229 
SetCommState(/pDCB):nResult 


Sets a communication device to the state specified by the device con- 
trol block [pDCB. The device to be set is identified by the ID field of 
the control block. 
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SetCursor page 91 
SetCursor(hCursor):hOldCursor 


Sets cursor shape to hCursor; removes cursor from screen if hCursor is 


NULL 


SetCursorPos page 91 
SetCursorPos(X, Y) 


Sets position of mouse cursor to screen coordinates given by X and Y. 


SetDlgItemInt page 43 
SetDigItemInt(hDig,nIDDigltem, wValue, bSigned) 
Sets text of nJDDigItem to string representing an integer. 


SetDlgItem Text page 44 
SetDigIltemText(hDig,nIDDigltem,|pString) 
Sets caption or text of nIDDigItem to IpString. 


SetEnvironment page 186 


SetEnvironment(lpPortName,!pEnviron,nCount):nCopied 


Copies data at lpEnviron to environment associated with device 
attached to given port. 


SetFocus page 56 

SetFocus(hWnd):hWndPrev 

Assigns the input focus to the window specified by hWnd. 
SetMapMode page 148 

SetMapMode(hDC,nMapMode):nOldMapMode 

Sets the mapping mode of the specified display context. 
SetMenu page 61 

SetMenu(h Wnd,hMenu):bSet 


Sets window menu to hMenu. Removes menu if hMenu is NULL. 
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SetMetaFileBits page 171 

SetMetaFileBits(hMem):hMF 

Creates memory metafile from data in the given global memory block. 
SetPixel page 123 

SetPixel(hDC,X, Y,rgbColor):rgbActualColor 

Sets pixel at X, Y to the device color closest to rgbColor. 
SetPolyFillMode page 147 

SetPolyFillMode(hDC,nPolyFillMode):nOldPolyFillMode 

Sets the polygon-filling mode for the specified display context. 
SetPriority page 207 

SetPriority(hTask,nChangeAmount):nNew 

Sets the task priority of the task hTask, and returns new priority. 
SetProp page 82 

SetProp(h Wnd,lpString,hData):bSet 

Copies string and data handle to property list of hWnd. 
SetRect page 97 

SetRect(/pRect,X1, Y1,X2, Y2):nResult 

Fills RECT structure at /pRect with given coordinates. 
SetRectEmpty page 97 

SetRectEmpty(lpRect):nResult 

Sets the rectangle to an empty rectangle (all coordinates are zero). 
SetRelAbs page 142 


SetRelAbs(hDC,nRelAbsMode):nOldRelAbsMode 
Sets the relabs flag. 
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SetResourceHandler page 216 
SetResourceHandler(hinstance,lpType,lpLoadFunc):lpLoadFunc 


Sets the function address of the resource handler for resources with 


type IpType. A resource handler provides for loading of custom 
resources. 


SetROP2 page 144 
SetROP2(hDC,nDrawMode):nOldDrawMode 


Sets the current drawing mode. 


SetScrollPos page 79 
SetScrollPos(hWnd,nBar,nPos,bRedraw):nOldPos 


Sets scroll bar elevator to nPos; redraws scroll bar if bRedraw is 
nonzero. 


SetScrollRange page 80 
SetScrollRange(hWnd,nBar,nMinPos,nMazPos,bRedraw) 
Sets minimum and maximum scroll bar positions for given scroll bar. 

SetSound Noise page 238 
SetSoundNoise(nSource,nDuration):nResult 
Sets the source and duration of a noise from the play device. 

SetStretchBlt Mode page 146 
SetStretchBltMode(hDC,nStretchMode):nOldStretchMode 
Sets the stretching mode for the StretchBlt function. 

SetSysColors page 102 
SetSysColors(nChanges,lpSysColor,lpColor Values) 

Changes one or more system colors. 

SetSysModalWindow page 86 

SetSysModal Window(h Wnd):hPrevWnd 


Makes the specified window a system-modal window. 


50 


Windows Functions 


SetTextCharacterExtra page 167 
Set TextCharacterExtra(hDC,nCharExtra):nOldCharExtra 


Sets the amount of intercharacter spacing. 


Set TextColor page 144 
Set TextColor(hDC,rgbColor):rgbOldColor 


Sets text color to the device color closest to rgbColor. 


Set Text Justification page 165 
SetTextJustification(hDC,nBreakEztra,nBreakCount):nSet 


Prepares GDI to justify a text line using nBreakEztra and 
nBreakCount. 


SetTimer page 59 
Set Timer(hWnd,nIDEvent,wElapse,lp TimerFunc):nIDNewEvent 


Creates system timer event identified by nJDEvent. wElapse is elapsed 
milliseconds. lp TimerF unc receives timer messages; if NULL, messages 
go to application queue. 


SetViewportExt page 156 
Set ViewportExt(hDC,X, Y):ptOldEztents 


Sets the z- and y-extents of the viewport of the specified display 
context. 


Set ViewportOrg page 153 

Set ViewportOrg(hDC,X, Y):ptOldOrigin 

Sets the viewport origin of the specified display context. 
SetVoiceAccent page 236 | 

Set VoiceAccent(n Votce,n Tempo,n Volume,nMode,nPitch):nResult 


Places an accent (tempo, volume, mode, and pitch) in the voice queue 
n Voice. 
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Set VoiceEnvelope page 237 
Set VoiceEnvelope(n Voice, nShape,nRepeat):nResult 


Places the envelope (wave shape and repeat count) in the voice queue 
nVoice. 


Set VoiceNote page 238 
Set VoiceNote(n Voice,n Value,nLength,nCdots):nResult 


Places a note in the voice queue nVoice. 


Set VoiceQueueSize page 235 
Set VoiceQueueSize(n Voice, nBytes):nResult 


Allocates nBytes of memory for the voice queue nVoice. Default is 
192 bytes. 


Set VoiceSound page 239 

Set VoiceSound(n Voice,nFrequency,nDuration):nResult 

Places a sound (frequency and duration) in the voice queue nVoice. 
Set VoiceThreshold page 242 

Set VoiceThreshold(n Voice,nNotes):nResult 


Sets the threshold level to nNotes for the voice queue nVoice. 


Set WindowExt page 152 
Set WindowExt(hDC,X, Y):ptOldEztents 


Sets the z- and y-extents of the window of the specified display 
context. 


Set WindowLong page 32 
Set WindowLong(hWnd,nIndez,|NewLong):lOldLong 
Changes the window attribute identified by nJIndez. 
Set WindowOrg page 151 
Set WindowOrg(hDC,X, Y):ptOldOrigin 


Sets the window origin of the specified display context. 
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Set WindowsHook page 103 
Set WindowsHook(nFilterType,lpFilterFunc):lpPrevFulterFunc 


Installs a system and/or application hook function. 
Set Window Text page 84 

Set Window Text(h Wnd,/pString) 

Sets window caption (if any) or text (if a control) to [pString. 
Set Window Word page 31 

Set Window Word(h Wnd,nIndez,wNewWord):wOld Word 

Changes the window attribute specified by n/ndez. 
ShowCaret _ page 94 

ShowCaret(h Wnd) 


Displays newly-created caret or redisplays hidden caret. 


ShowCursor page 92 
ShowCursor(bShow):nCount 


Adds 1 to cursor display count if bShow is nonzero. Subtracts 1 if 
bShow is zero. 


Show Window page 33 

Show Window(hWnd,nCmdShow):bShown 

Displays or removes the given window as specified by nC'mdShow. 
SizeofResource page 216 


SizeofResource(hAl/nstance,hResInfo):wBytes 


Returns the size, in bytes, of resource hResInfo. 


StartSound page 240 
StartSound( ):nResult 


Starts play in each voice queue. 
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StopSound page 240 
StopSound( ):nResult 


Stops playing all voice queues, and flushes the contents of the queues. 


StretchBlt page 117 


StretchBlt(hDestDC,X, Y,n Width, nHetght,hSreDC,XSre, YSre, 
nSreWidth,nSrcHetght,dwRop):bDrawn 


Moves bitmap from source rectangle into destination rectangle, 
stretching or compressing as necessary. Source origin is at XSrc, YSrc. 
X, Y, nWidth, and nHezght give origin and dimensions of rectangle on 
destination device. dwRop defines how source and destination bits are 
combined. 


SwapMouseButton see Update 
SwapMouseButton(bSwap):bSwapped 


Swaps the meaning of the left and right mouse buttons if bSwap is 
TRUE. 


SyncAllVoices _— page 241 
SyncAllVoices( ):nResult 


Places a syne mark in each voice queue. Voices wait at the sync mark 
until all queues have encountered it. 


TextOut page 119 
TextOut(hDC,X, Y,lpString,nCount):bDrawn 


Writes character string using current font and starting at X, Y. 
Throw page 195 
Throw(lpCatchBuf,n ThrowBack) 


Restores the execution environment to the values in buffer lnCatchBuf. 
Execution continues at the location specified by the environment with 
the return value nThrowBack available for processing. 


TranslateAccelerator page 16 
TranslateAccelerator(hWnd,hAccTable,lpMsg):n Translated 


Processes keyboard accelerators for menu commands. 
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TranslateMessage page 15 
TranslateMessage(!pMsg):b Translated 


Translates virtual keystroke messages into character messages. 


TransmitCommChar page 228 
TransmitCommChar(nCid,cChar):nResult 


Places the character cChar at the head of the transmit queue for 
immediate transmission. 


UngetCommChar page 228 
UngetCommChar(nCid,cChar):nResult 


Makes the character cChar the next character to be read from the 
recelve queue. 


UnionRect _— page 98 
UnionRect(IpDestRect,lpSrciRect,lpSrc2Rect):nUnion 


Stores the union of two rectangles at [pDestRect. 


UnlockData _ page 205 
UnlockData( Dummy) 
Unlocks the data segment. 


UnlockSegment _ see Update 
UnlockSegment(wSegment):hMem 


Unlocks the segment whose segment address is wSegment. 


UnrealizeObject page 158 
UnrealizeObject(hBrush):bUnrealized 


Directs GDI to reset the origin of the given brush the next time it is 
selected. 


UpdateWindow page 74 
Update Window(h Wnd) 


Notifies application when parts of a window need redrawing after 
changes. 
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ValidateRect page 76 
ValidateRect(hWnd,lpRect) 


Releases from repainting rectangle specified by /pRect (in client 
coordinates). If IpRect is NULL, entire window is validated. 


ValidateRgn page 77 
ValidateRgn(hWnd,hRgn) 


Releases hRgn from repainting. If hRgn is NULL, entire region is 
validated. 


WaitMessage page 13 
WaitMessage( ) 


Yields control to other applications when application has no tasks to 
perform. 


WaitSoundState page 240 
WaitSoundState(nState):nResult 
Waits until the play driver enters the state nState. 


WindowFromPoint page 96 
WindowFromPoint(Point):hWnd 
Identifies the window containing Point (in screen coordinates). 
WinMain page 9 
WinMain(Alnstance,hPrevinstance,lpCmdLine,nCmdShow):nExit Code 
Serves as entry point for execution of a Windows application. 
WndProc page 20 
WndProc(hWnd,wMsg,wParam,|Param):lReply 


Processes messages sent to it by Windows or the application’s main 
function. 


WriteComm sppage 227 
WriteComm(nCid,/pBuf, nSize):nBytes 


Writes up to nSize bytes from buffer [pBuf to communication device 
nCid. 
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WriteProfileString page 224 
WriteProfileString(/pApplicationName,|pKeyName,|pString):bResult 


Copies character string /pString to the win.ini file. The string replaces 
the current string named by IpKeyName in section lpSectionName. If 
the key or section does not exist, a new key and section are created. 


Yield page 206 
Yield( ):bResult 


Halts the current task and starts any waiting task. 
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Index to Programmer’s Reference 


Message 


BM_ GETCHECK 
BM_ GETSTATE 
BM_ SETCHECK 
BM_ SETSTATE 


EM_ GETLINECOUNT 
EM_ GETMODIFY 
EM_ GETRECT 

EM_ GETSEL 

EM_ LIMITTEXT 
EM_ LINEINDEX 
EM_ LINELENGTH 
EM_ LINESCROLL 
EM_ REPLACESEL 
EM_ SETFONT 

EM_ SETHANDLE 
EM_ SETMODIFY 
EM_ SETRECT 

EM_ SETRECTNP 
EM_ SETSEL 

EM_ UNDO 

LB_ ADDSTRING 
LB_ DELETESTRING 
LB_ DIR 

LB_ GETCOUNT 
LB_ GETCURSEL 
LB_ GETSEL 

LB_ GETTEXT 

LB_ GETTEXTLEN 
LB_ INSERTSTRING 
LB_ RESETCONTENT 
LB_ SELECTSTRING 
LB_ SETCURSEL 
LB_ SETSEL 

WM_ ACTIVATE 
WM_ ACTIVATEAPP 


Page Message 


388 
389 
389 
389 
395 
396 
392 
394 
392 


oe 
390 


398 
398 
353 
354 


WM_ ASKCBFORMATNAME 
WM_ CANCELMODE 
WM_ CHANGECBCHAIN 
WM_ CHAR 

WM_ CLEAR 

WML_ CLOSE 

WM_ COMMAND 

WM_ COPY 

WM_ CREATE 

WM_ CTLCOLOR 

WM_ CUT 

WM_ DEADCHAR 

WM_ DESTROY 

WM_ DESTROYCLIPBOARD 
WM_ DEVMODECHANGE 
WM_ DRAWCLIPBOARD 
WM_ ENABLE 
WM_ENDSESSION 

WM_ ERASEBKGND 
WM_ FONTCHANGE 
WM_ GETDLGCODE 
WM_ GETTEXT 

WM_ GETTEXTLENGTH 
WM_ HSCROLL 
WM_HSCROLLCLIPBOARD 
WML INITDIALOG 

WML INITMENU 

WM_ INITMENUPOPUP 
WM_KEYDOWN 

WM_ KEYUP | 
WML_KILLFOCUS 
WM_LBUTTONDBLCLK 
WM_LBUTTONDOWN 
WM_LBUTTONUP 

WM_ MBUTTONDBLCLKI 
WM_MBUTTONDOWN 
WM_ MBUTTONUP 

WM_ MOUSEMOVE 

WM_ MOVE 


382 
372 
397 
361 
374 
396 
352 
398 
396 
373 
361 
382 
386 
382 
353 
362 
307 
386 
360 
359 
359 
376 
385 
363 
363 
362 
370 
371 
393 
368 
365 
365 
370 
367 
368 
364 
357 


« See the Microsoft Windows Update to Programmer’s Reference and Programming Guide 
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Index to Programmer’s Reference (continued) 


Message Page Message Page 
WM_ NCACTIVATE 405 WM_RENDERALLFORMATS — 382 
WM_ NCCALCSIZE 403 WM_ RENDERFORMAT 381 
WM_ NCCREATE 403 WM_SETFOCUS 353 
WM_ NCDESTROY 403 WM_SETREDRAW 359 
WM_ NCHITTEST 404 WM_SETTEXT 359 
WM_NCLBUTTONDBLCLK = 406 WM_SETVISIBLE 352 
WM_ NCLBUTTONDOWN 405 WM_SHOWWINDOW 355 
WM_ NCLBUTTONUP 406 WML_ SIZE 356 
WM_NCMBUTTONDBLCLK = 408 WML_ SIZECLIPBOARD 383 
WM_ NCMBUTTONDOWN 407 WML_ SIZEWAIT . 
WM_ NCMBUTTONUP 407 WM_SYSCHAR 379 
WM_ NCMOUSEMOVE 405 WM_SYSCOLORCHANGE 386 
WM_ NCPAINT 405 WM_SYSCOMMAND 380 
WM_NCRBUTTONDBLCLK = 407 WM_SYSDEADCHAR 380 
WM_ NCRBUTTONDOWN 406 WM_SYSKEYDOWN 377 
WM_ NCRBUTTONUP 407 WM_SYSKEYUP 378 
WML PAINT 357 WM_SYSTEMERROR 387 
WM_ PAINTCLIPBOARD 383 WM_SYSTIMER x 
WWM_ PASTE 361 WM_ TIMECHANGE 387 
WM_ QUERYENDSESSION 361 WM_ TIMER 374 
WM_ QUERYOPEN 352 WM_ UNDO 395 
WM_ QUIT 362 WM_ VSCROLL 375 
WM_ RBUTTONDBLCLK 369 WM_ VSCROLLCLIPBOARD 384 
WM_RBUTTONDOWN 366 WML_ WININICHANGE 387 
WM_ RBUTTONUP 366 


* See the Microsoft Windows Update to Programmer’s Reference and Programming Guide 
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Message Parameters 


Message wParam lParam (low/high) 
WM_ ACTIVATE activation type? window handle®/iconic flag® 
WM_ ACTIVATEAPP activation flag? task handle® 

WM_ ASKCBFORMATNAME _ bytes to copy LPSTR to buffer 

WM_ CANCELMODE - - 

WM_ CHANGECBCHAIN window handle! window handle® 

WM_ CHAR ASCII value key state 

WML_ CLOSE - | - 

WM_ COMMAND command ID! command type 

WM_ CREATE - LPCREATESTRUCT 
WM_ CTLCOLOR HDC to child child handle/control type* 
WM_ DEADCHAR dead key value key state 

WM_ DESTROY - - 
WM_DESTROYCLIPBOARD_~ - - 

WM_ DEVMODECHANGE - LPSTR to device name 
WM_ DRAWCLIPBOARD - - 

WML_ ENABLE disabled flag! - 

WM_ENDSESSION end session flag™ - 


a - 
5 - 
is 


d- 


e€ - 


m- 


Activation type is zero if inactivated, 1 if activated by non-mouse, 2 if activated by 
mouse. 


Low-order word is handle of window being inactivated if activation type is 1 or 2, other- 
wise, it is handle to window being activated. 


High-order word is nonzero if window iconic, zero otherwise. 
Activation flag is nonzero if application is being activated, zero otherwise. 


Low-order word is handle to task being inactivated if activation flag is nonzero, otherwise 
it is handle to task being activated. 


Handle to window being removed from chain. 
Low-order word is handle to window following the removed window. 


Bits 1-16: repeat count; bits 17-25: OEM scan code; bit 29: 1, if with ALT key, zero if not, 
bit 30: 1 if key pressed before, zero if not; bit 31: 1 if key released, zero if pushed. 


Menu item ID, control ID, or accelerator ID. 


Zero if menu item; 1 in high-order word if accelerator key; window handle in low-order 
word and notification code in high-order word if control. 


High-order word is CTLCOLOR_ MSGBOX, CTLCOLOR_ EDIT, CTLCOLOR_ LISTBOX, 
CTLCOLOR_- BTN, CTLCOLOR_ DLG, CTLCOLOR_ SCROLLBAR, or 
CTLCOLOR_ STATIC. 


Disabled flag is nonzero if window is disabled, zero otherwise. 
End session flag is nonzero if session ending, zero if continuing. 
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Message Parameters (continued) 


Message 


WM_ ERASEBKGND# 
WM_ FONTCHANGE 
WM_ GETDLGCODE> 
WM_ GETTEXT® 


WM_ GETTEXTLENGTH? 


WM_ HSCROLL 


WM_ HSCROLLCLIPBOARD 


WML INITDIALOG! 


WML_ KILLFOCUS 
WM_LBUTTONDBLCLK 
WM_ LBUTTONDOWN 
WM_LBUTTONUP 


WM_ MBUTTONDBLCLK 


WM_ MBUTTONDOWN 


wParam 


HDC to window 


max. byte count 
scroll code® 
window handle& 
control handle! 
menu handle 
menu handle 
VK key code 
VK_ key code 
window handle™ 
key state” 

key state” 

key state” 

key state® 

key state” 


[Param (low/high) 


LPSTR to buffer 


shun position! 
scroll code 


item index/system menu* 
key state! 
key state* 


POINT? 
POINT? 
POINT? 
POINT°® 
POINT? 


a- Must return nonzero if background erased, zero otherwise. 


b- Must return DLGC_WANTARROWS, DLGC. WANTTAB, DLGC_ WANTALLKEYS, or 


DLGC_ HASSETSEL. 


c- Must return number of bytes copied. 
d- Must return number of bytes in title text. 


e- SB. LINEUP, SB_-LINEDOWN, SB_- PAGEUP, SB- PAGEDOWN, 
SB_THUMBPOSITION, SB_ THUMBTRACK, SB_ TOP, SB_ BOTTOM, or 


SB_ ENDSCROLL. 


f- Thumb position in low-order word for SB. THUMBPOSITION and SB_ THUMBTRACK 


only. 


- Handle to Clipboard application window ( clipbrd. eze). 


:. SB_ LINEUP, SB_- LINEDOWN, SB_ PAGEUP, SB- PAGEDOWN, 
SB. THUMBPOSITION, SB_ TOP, SB_ BOTTOM, or SB_ENDSCROLL in low-order 
word, and thumb position in high-order word if SB. THUMBPOSITION. 


i- Must return nonzero to give first control input focus, otherwise, must return zero. 
)- Handle to first control that can receive input focus. 
k - High-order word is nonzero if the menu is the System menu, zero otherwise. 


1- Bits 1-16: repeat count; bits 17-25: OEM scan code; bit 29: 1 if with ALT key, zero if not; 
bit 30: 1 if key pressed ‘before, zero if not; bit 31: 1 if key released, zero if pushed. 


m - Handle to window gaining the input focus. 
n- Acombination of MK_- RBUTTON, MK_ LBUTTON, MK_ MBUTTON, MK_ SHIFT, and 
MK_ CONTROL 


o- Mouse position in client coordinates. 


Window Messages 


Message Parameters (continued) 


Message wParam [Param (low/high) 
WM_MBUTTONUP key state? POINT? 

WM_ MOUSEMOVE key state? POINT» 

WM_ MOVE - POINT* 

WM_ NCACTIVATE caption flag? - 

WM_ NCCALCSIZE - LPRECT® 

WM_ NCCREATE! window handle LPCREATESTRUCT 
WM_ NCDESTROY - - 

WML_ NCHITTESTS - POINT 

WM_ NCLBUTTONDBLCLK hit type® POINT! 

WM_ NCLBUTTONDOWN hit type" POINT? 

WM_ NCLBUTTONUP hit type® POINT 
WM_NCMBUTTONDBLCLK shit type® POINT' 

WM_ NCMBUTTONDOWN hit type POINT' 

WM_ NCMBUTTONUP hit type POINT' 

WM_ NCMOUSEMOVE hit type® POINT! 

WM_ NCPAINT - - 
WM_NCRBUTTONDBLCLK shit type? POINT 

WM_ NCRBUTTONDOWN hit type® POINT! 

WM_ NCRBUTTONUP hit type® POINT' 

WML_ PAINT - . LPPAINTSTRUCT 
WML_ PAINTCLIPBOARD window handle! LPPAINTSTRUCT 
WM. QUERYENDSESSIONK _ - ‘ 

WM_ QUERYOPEN! - - 

WM_ QUIT exit code - 


a- Acombination of MK. RBUTTON, MK_ LBUTTON, MK- MBUTTON, MKkK~— SHIFT, and 
~ MK_ CONTROL. 


b- Mouse position in client coordinates. 

c- Screen coordinates of window’s upper-left corner. 

d- Caption flag is nonzero if the caption is active, zero if inactive. 
e- Screen coordinates of window rectangle. 

f- Must return nonzero if non-client area created, zero otherwise. 


g- Must return HTNOWHERE, HTERROR, HTTRANSPARENT, HTCLIENT, 
ee ee , HTSYSMENU, HTGROWBAR, HTMENU, HTHSCROLL, or 


h - HTNOWHERE, HTERROR, HTTRANSPARENT, HTCLIENT, HTCAPTION, 
HTSYSMENU, HTGROWBAR, HTMENU, HTHSCROLL, or HTVSCROLL. 


i- Mouse position in screen coordinates. 

j- Handle to Clipboard application window (clipbrd. eze). 

k - Must return nonzero to continue end of session, zero to prevent it. 
1- Must return nonzero to open icon, zero otherwise. 
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Message Parameters (continued) 


Message 


WM_ RBUTTONDBLCLK 


WM_ RBUTTONDOWN 
WM_ RBUTTONUP 


WM_~ RENDERALLFORMATS 
WM_ RENDERFORMAT 


WM_SETFOCUS 

WM_ SETREDRAW 
WM_SETTEXT 
WM_SETVISIBLE 
WM_ SHOWWINDOW 
WWM_ SIZE 

WML_ SIZECLIPBOARD 
WML_SYSCHAR 


WM_SYSCOLORCHANGE 


WM_SYSCOMMAND 
WM_ SYSDEADCHAR 
WM_SYSKEYDOWN 
WM_SYSKEYUP 
WM_ SYSTEMERROR 
WML_SYSTIMER 


wParam 


key state? 

key state* 

key state? 
format type 
window handle? 
redraw flag 


show flag® 

show flag 

size types 
window handle? 
VK_— key code 
command ID! 
dead key code 
VK~— key code 
VK~— key code 


8 (out-of-memory) 


lParam (low/high) 


POINT® 
POINT® 
POINT® 


LPSTR to text 


show type! 
width hei ht 
LPR CT 
key state! 


key state! 
key state! 
key state! 


a- A combination of MK- RBUTTON, MK_ LBUTTON, MK_ MBUTTON, MK~_ SHIFT, and 


MK_~ CONTROL. 


b- Mouse position in client coordinates. 
c- CF_ TEXT, CF. BITMAP, CF. TEXT, CF. BITMAP, CF_ METAFILEPICT, CF_ SYLK, 


CF_ DIF’, or a private type. 


d- Handle to window losing the input focus. 


e- Show flag is nonzero if the window is shown, zero if hidden. 
f- Zero if ShowWindow function called, otherwise SW_ O 


THERZOOM, 
SW_ OTHERUNZOOM, SW_ PARENTCLOSING, or SW. PARENTOPENING. 
g- SIZEICONIC, SIZEFULLSCREEN, SIZENORMAL, SIZEZOOMSHOW, or 


SIZEZOOMHIDE. 


h- Handle to Clipboard application window (clipbrd.eze). 


i- Bits 1-16: repeat count; bits 17-25: OEM scan code; bit 29: 1 if with ALT key, zero if not; 
bit 30: 1 if key pressed before, zero if not; bit 31: 1 if key released, zero if pushed. 


}- SC_SIZE, SC_MOVE, SC_ICON, SC_ ZOOM, SC_ CLOSE, SC_ NEXTWINDOW, 


SC_ 
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SC_ PREVWINDOW, SC_ VSCROLL, SC_ HSCROLL, SC_ 
KEYMENU. 


MOUSEMENU, or 


Window Messages 


Message Parameters (continued) 


Message wParam lParam (low/high) 
WM_ TIMECHANGE - - 

WML_ TIMER timer ID FARPROC? 

WML_ VSCROLL scroll code® thumb position® 
WM_VSCROLLCLIPBOARD _ window handle? scroll code® 

WM_ WININICHANGE - LPSTR to section name! 


a- Long pointer to timer call-back function. 

b- SB_LINEUP, SB_-LINEDOWN, SB. PAGEUP, SB- PAGEDOWN, 
SB_THUMBPOSITION, SB_ THUMBTRACK, SB_ TOP, SB_ BOTTOM, or 
SB_ ENDSCROLL. 

c - sone position in low-order word for SB. THUMBPOSITION and SB_ THUMBTRACK 
only. 

d- Handle to Clipboard application window (clipbrd. eze). 

e- SB_ LINEUP, SB-LINEDOWN, SB_- PAGEUP, SB- PAGEDOWN, 
SB_ THUMBPOSITION, SBU TOP, SB_ BOTTOM, or SB_ENDSCROLL in low-order 
word, and thumb position In high-order word if SB_ THUMBPOSITION. 

f- NULL if more than one section changed. 


Button-Control Messages 


Message Parameters 


Message wParam lParam (low/high) 


BM_ GETCHECK? - - 
BM_ GETSTATE> - - 
BM_ SETCHECK check flag - 
BM_SETSTATE state flag - 


a- Returns zero if not checked, 1 if checked, 2 if grayed (3-state only). 
b- Returns zero if no highlight, 1 if highlight. 

c- If zero, clear check. If 1, set check. If 2, gray check (3-state only). 
d- If 1, set highlight. If zero, clear highlight. 
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Edit-Control Messages 


Message Parameters 


Message wParam [Param (low/high) 
EM_ CANUNDO® - - 

EM_FMTLINES®> format flag - 

EM_ GETHANDLE* - - 

EM_ GETLINE* line number LPSTR° 

EM_ GETLINECOUNT! - - 

EM_ GETMODIF'Y® - - 

EM_ GETRECT - LPRECT® 

EM_ GETSEL! - - 

EM_ LIMITTEXT max. bytes - 

EM_ LINEINDEX? line number - 

EM_ LINELENGTH* line number - 

EM_ LINESCROLL - line scroll/character scroll 
EM_ REPLACESEL - LPSTR'! 

EM_ SETFONT font ID™ - 

EM_ SETHANDLE buffer handle® - 

EM_ SETMODIFY modify flag? - 

EM_ SETRECT - LPRECT? 

EM_ SETRECTNP - LPRECT‘ 


a- Returns TRUE if can undo last change. 

b- Returns TRUE if text formatted. 

c- Returns handle to text buffer (relative to local heap). 
d- Returns number of lines in text. 

e- Long pointer to buffer to receive text. 

f- Returns number of lines of text. 

g- Returns state of modify flag. 

h - Long pointer to buffer to receive rectangle. 

i- Returns start- and end-character positions of the selection. 
}- Returns character position of line. 

k - Returns character length of line. 

|- Long pointer to replacement string. 

m - Font constant from GetStockObject function. 

n- Handle to text buffer (relative to local heap). 

o- Must be TRUE to set modify flag. 

p - Long pointer to rectangle. 

q- Long pointer to rectangle. 


69 


Microsoft Windows Quick Reference 


Message Parameters (continued) 


Message wParam 


EM_ SETSEL 
EM_ UNDO? 
WM_ CLEAR 
WM_ COPY 
WM_ CUT 
WM_ UNDO 


a- Returns TRUE if last change restored. 
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lParam (low/high) 


start pos./end pos. 


List-Box Messages 


Message Parameters 


Message wParam lParam (low/high) 


LB_ ADDSTRING?* - LPSTR> 
LB_ DELETESTRING* index - 

LB_ DIR4 DOS attributes LPSTR* 
LB_ GETCOUNT! - - 

LB_ GETCURSEL& - - 

LB_ GETSEL® _ index - . 
LB_ GETTEXT' index LPSTR) 
LB_ GETTEXTLEN* index - 

LB_ INSERTSTRING! index LPSTR®™ 
EM_ RESETCONTENT - - 

LB_ SELECTSTRING® index LPSTR° 
LB_ SETCURSEL index - 

LB_ SETSEL set /clear flag? index /- 


a- Returns index for string. 

b - Long pointer to new string. 

c- Returns number of strings in list box. 
d- Returns number of strings added to list box. 
e- Long pointer to pathname specification. 
f- Returns number of strings in list box. 
g- Returns index of selection. 

h- Returns TRUE if string is selected. 

1- Returns character length of string. 

j- Long pointer to buffer to receive text. 

k - Returns character length of string. 

1- Returns index of inserted string. 

m - Long pointer to string. 

n- Returns index of selected string. 

o- Long pointer to buffer to receive string. 
p- If TRUE, select string. 
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Windows Message Numeric List 


Code 


0x0001 
0x0002 
0x0003 
0x0005 
0x0006 
0x0007 
0x0008 
0x0009 


Message 


WM_ CREATE 
WM_ DESTROY 
WM_ MOVE 

WML SIZE 

WM_ ACTIVATE 
WM_SETFOCUS 
WM_ KILLFOCUS 
WM_SETVISIBLE 


0x000A WM_ ENABLE 


0x000B 


WM_ SETREDRAW 


0x000C WM_SETTEXT 
0x000D WM_ GETTEXT 


0x000E 
Ox000F 
0x0010 
Ox0011 
0x0012 
0x0013 
0x0014 
Ox0015 
Ox0016 
0x0017 
0x0018 
0x0019 


WM_ GETTEXTLENGTH 
WM_ PAINT 

WM_ CLOSE 

WM_ QUERYENDSESSION 
WM_ QUIT 

WM_ QUERYOPEN 
WM_ERASEBKGND 
WM_SYSCOLORCHANGE 
WM_ENDSESSION 
WM_SYSTEMERROR 
WM_SHOWWINDOW 
WM_CTLCOLOR 


0x001A WM_ WININICHANGE 
0x001B WM_ DEVMODECHANGE 
0x001C WM_ ACTIVATEAPP 
0x001D WM_ FONTCHANGE 
0Ox00LE WM_ TIMECHANGE 


Ox001f 
0x0081 
O0x0082 
0x0083 
0x0084 
0x0085 
Ox0086 
0x0087 


WM_ CANCELMODE 
WM_ NCCREATE 
WM_ NCDESTROY 
WM_ NCCALCSIZE 
WML_ NCHITTEST 
WM_ NCPAINT 
WM_ NCACTIVATE 
WM_ GETDLGCODE 


0x00A0 WM_ NCMOUSEMOVE 


Ox00A1 


WM_ NCLBUTTONDOWN 


0x00A2 WM_ NCLBUTTONUP 
0x00A3 WM_ NCLBUTTONDBLCLK 
0x00A4 WM_ NCRBUTTONDOWN 


Code 


Message 


0x00A5 WM_ NCRBUTTONUP 
0Ox00A6 WM_ NCRBUTTONDBLCLK 
0x00A7 WM_ NCMBUTTONDOWN 
0Ox00A8 WM_ NCMBUTTONUP 
0x00A9 WM_ NCMBUTTONDBLCLK 


0x0100 
0x0101 
0x0102 
0x0103 
0x0104 
0x0105 
0x0106 
0x0107 
0x0110 
Ox0111 
0x0112 
0x0113 
0x0114 
0x0115 
0x0116 
0x0117 
0x0118 
0x0200 
0x0201 
0x0202 
0x0203 
0x0204 
0x0205 
0x0206 
0x0207 
0x0208 
0x0209 
0x0305 
0x0306 
0x0307 
0x0308 
0x0309 


WM_ DEADCHAR 
WM_ SYSKEYDOWN 
WM_SYSKEYUP 
WM_SYSCHAR 
WML_SYSDEADCHAR 
WML INITDIALOG 


WM_ HSCROLL 

WML_ VSCROLL 

WM_ INITMENU 

WML INITMENUPOPUP 
WM_SYSTIMER 

WM_ MOUSEMOVE 
WM_LBUTTONDOWN 
WM_LBUTTONUP 
WM_LBUTTONDBLCLKIK 
WM_ RBUTTONDOWN 
WM_ RBUTTONUP 

WM_ RBUTTONDBLCLKI 
WM_ MBUTTONDOWN 
WM_ MBUTTONUP 

WM_ MBUTTONDBLCLK 
WM_ RENDERFORMAT 
WM_ RENDERALLFORMATS 
WM_ DESTROYCLIPBOARD 
WM_ DRAWCLIPBOARD 
WM_ PAINTCLIPBOARD 


0x030A_ WM_ VSCROLLCLIPBOARD 
0x030B WM_ SIZECLIPBOARD 
0x030C WM_ ASKCBFORMATNAME 
0x030D WM_ CHANGECBCHAIN 
0x030E WM_ HSCROLLCLIPBOARD 
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